KEY 관리
마스터 관리자가 고객사(테넌트)별로 제품 라이선스 KEY를 발급하고 관리하는 메뉴입니다. 발급한 KEY는 고객에게 전달하며, KEY의 등록·활성화는 고객사가 각 제품의 콘솔에서 직접 수행합니다. 본 메뉴는 최고 마스터 관리자(SCMASTER) 전용입니다.
발급 시 제품을 선택하면 해당 제품에 맞는 입력 항목이 표시됩니다. 현재는 SDF 제품을 지원하며, 지원 제품은 순차적으로 추가될 예정입니다.
목차
- 기본 화면 구성
- KEY 관리 목록
- 라이선스 KEY 발급
- 제품별 설정 항목
- 발급 완료 및 KEY 전달
- KEY 상세 확인
- KEY 폐기
- 자주 보는 안내 메시지
기본 화면 구성
마스터 관리자 가이드의 구독 화면은 두 개의 탭으로 구성됩니다.
- 구독 탭: 테넌트별 구독 추가·전환·해제를 관리합니다.
- KEY 관리 탭: 고객사별 제품 라이선스 KEY를 발급·조회·폐기합니다. (본 문서에서 설명)
구독 > KEY 관리 탭을 클릭하면 발급된 KEY 목록 화면이 열립니다.
⚠️ KEY 관리 탭은 최고 마스터 관리자(SCMASTER)만 접근·발급·폐기할 수 있습니다. 다른 관리자 등급에는 노출되지 않습니다.
KEY 관리 목록
발급된 KEY를 고객사 단위로 한눈에 확인하는 목록입니다.
| 컬럼 | 설명 |
|---|---|
| 회사 | KEY를 발급한 고객사(테넌트) 이름 |
| 제품 | 발급한 제품 (예: SDF) |
| 구독 상태 | KEY의 현재 상태 (유효 / 만료 / 미활성) |
| 구독 기간 | KEY의 사용 기간 YYYY.MM.DD ~ YYYY.MM.DD |
| 발급된 날짜 | 마스터가 KEY를 발급한 날짜 |
| 등록일 | 고객사가 제품 콘솔에서 KEY를 등록한 날짜 (미등록 시 미등록) |
구독 상태 값
- 유효: 현재 사용 기간 내에서 정상 동작하는 KEY입니다.
- 만료: 사용 기간이 지나 더 이상 유효하지 않은 KEY입니다.
- 미활성: 시작일이 아직 도래하지 않은 KEY입니다. 미래 시작일로 사전 발급한 경우이며, 시작일이 되면 자동으로
유효로 전환됩니다.
💡 목록에는 KEY가 정상 발급된 고객사만 표시됩니다. 아직 발급하지 않은 고객사는 나타나지 않습니다.
발급된 KEY가 하나도 없으면 발급된 라이선스 KEY가 없습니다. 안내가 표시됩니다.
라이선스 KEY 발급
고객사별로 제품 라이선스 KEY를 새로 발급합니다.
전제조건
- 대상 고객사(테넌트)가 이미 생성되어 있어야 합니다.
- 해당 고객사에 발급하려는 제품의 구독이 활성 상태여야 발급 대상 목록에 표시됩니다.
⚠️ 회사(테넌트)가 없거나 해당 제품 구독이 없는 고객사에는 KEY를 발급할 수 없습니다.
사용 방법
KEY 관리탭 상단의[라이선스 KEY 발급]버튼을 클릭합니다.- 회사를 선택합니다. (발급하려는 제품 구독이 활성인 고객사만 표시됩니다.)
- 제품을 선택합니다. 선택한 제품에 따라 입력 항목이 달라집니다. (현재 지원: SDF)
- 선택한 제품에 맞는 항목을 입력합니다. → 아래
제품별 설정 항목참고 - 구독 기간의 시작일과 만료일을 선택합니다.
[KEY 발급]버튼을 클릭합니다.
💡 시작일을 미래 날짜로 지정하면 KEY 상태가 미활성으로 발급됩니다. 계약 시작일에 맞춰 미리 발급해 둘 때 사용하며, 시작일이 되면 자동으로 유효로 전환됩니다.
⚠️ 다음 경우 발급이 차단되고 사유가 안내됩니다.
- 시작일이 만료일보다 뒤일 때
- 수량 항목이 1 미만일 때
- 등록되지 않은 회사를 대상으로 할 때
제품별 설정 항목
발급 시 선택한 제품에 따라 입력 항목이 달라집니다. 공통 항목은 회사 · 제품 · 구독 기간(시작일~만료일)이며, 그 외 수량 항목은 제품별로 다릅니다.
SDF 선택 시
| 항목 | 필수 | 설명 |
|---|---|---|
| 업무시스템 수 | 필수 | 라이선스에 포함할 업무시스템 수. 1 이상. |
| 식별자 수 | 필수 | 라이선스 에 포함할 식별자 수. 1 이상. |
| SDF APP 수 | 필수 | 라이선스에 포함할 SDF APP 수. 1 이상. |
💡 다른 제품이 추가되면, 제품 선택 시 해당 제품에 맞는 설정 항목이 이 자리에 표시됩니다.
발급 완료 및 KEY 전달
발급이 완료되면 라이선스 KEY 발급 완료 화면이 표시됩니다.
- 생성된 라이선스 KEY 문자열이 표시됩니다.
[키 복사]아이콘을 클릭하면 KEY가 클립보드로 복사되고, 아이콘이 체크 표시(복사됨)로 바뀝니다.- 대상 회사·제품·수량·구독 기간의 계약 요약이 함께 표시됩니다.
[확인]버튼을 클릭하면 완료 화면이 닫히고, KEY 관리 목록에 새 KEY가 반영됩니다.
⚠️ 발급된 KEY는 최초 1회만 확인할 수 있습니다. 완료 화면을 닫으면 다시 표시되지 않으므로, 반드시 [키 복사]로 복사하여 안전한 곳에 보관한 뒤 고객에게 전달하세요.
KEY 전달 이후: 고객사 관리자는 전달받은 KEY를 해당 제품의 고객 콘솔에서 직접 등록·활성화합니다. 등록·활성화는 본 메뉴의 범위가 아닙니다.
KEY 상세 확인
목록에서 행을 클릭하면 해당 고객사의 KEY 상세 정보가 오른쪽 드로어로 열립니다.
- 계약 내용(제품별 수량 항목), 구독 기간, 구독 상태, 발급된 날짜, 등록일을 확인할 수 있습니다.
- 등록일은 고객사가 제품 콘솔에서 KEY를 등록하면 표시됩니다. 아직 등록 전이면
미등록으로 나타납니다.
⚠️ 보안을 위해 평문 KEY 문자열은 상세 화면에서 다시 표시되지 않습니다. KEY 확인은 발급 완료 화면에서의 1회만 가능합니다.
KEY 폐기
발급한 KEY를 폐기합니다.
사용 방법
- 목록에서 대상 고객사 행을 클릭해 상세 드로어를 엽니다.
[KEY 폐기]버튼을 클릭합니다.- 확인 다이얼로그에서
[폐기]를 클릭합니다.
⚠️ 폐기된 KEY는 복구할 수 없으며, 해당 회사는 즉시 해당 제품 사용이 제한됩니다. 신중히 진행하세요.
💡 KEY 폐기는 최고 마스터 관리자(SCMASTER)만 수행할 수 있습니다.
📌 현재는 KEY를 목록에서 폐기하는 기능만 제공됩니다. SDF 폐기(revoke) 연동 API가 아직 제공되지 않아, 폐기 상태 표시 등 정식 폐기 처리는 추가 예정입니다. (지원 제품이 추가되면 제품별 폐기 처리도 함께 반영됩니다.)